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Les web services avec J AX-WS 2.0 

JAX-WS est la nouvelle appellation de JAX-RPC (Java API for XML Based RPC) qui 
permet de developper tres simplement des services web. JAX-WS fournit un ensemble 
d'annotations pour mapper la correspondance Java-WSDL. II suffit pour cela d'annoter 
directement les classes Java qui vont representer le service web. En ce qui concerne le client, 
JAX-WS permet d'utiliser une classe proxy pour appeler un service distant et masquer la 
complexite du protocole. Ainsi, ni le client ni le serveur n'ont besoin de generer ou de parser les 
messages SOAP. JAX-WS s'occupe de ces traitements de bas niveau. 

Dans l'exemple ci-dessous, une classe Java utilise des annotations JAX-WS qui vont permettre 
par la suite de generer le document WSDL. Le document WSDL est auto-generer par le serveur 
d'application au moment du deploiement : 

@WebService( ) 

public class Banque { 

@WebMethod 

public double conversionEuroToDh(double mt) { 

}" 

}" 

JAX-WS s'appuie sur 1API JAXB 2.0 pour tout ce qui concerne la correspondance entre 
document XML et objets Java. Un graphe d'objets est constitue suivant les elements constituant 
le document XML. JAXB (Java Architecture for XML Binding) facilite la correspondance 
bidirectionnelle en fournissant un niveau d'abstraction plus eleve que SAX ou DOM et en 
s'appuyant sur les annotations. 

Par exemple, si nous desirons obtenir une representation XML de la classe Client, il suffit de 
l'annoter avec @javax.xml.bind.annotation.XmlRootElement. D'autres annotations permettent de 
specifier qu'un attribut est un identifiant avec @XmlID ou de renommer un attribut (e-mail au 
lieu de email, par exemple) avec @XmlAttribute : 

@XmlRoot Element 

public class Client { 

@XmlID 

private String id; 

private String nom; 

private String prenom; 

@XmlAttribute(name="e-mail" ) 

private String email; 

} 
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Ces annotations permettent alors de generer le document XML suivant a partir de la classe, et 
inversement : 

<?xml version="1.0" encoding="UTF-8"?> 
<client> 

<id>3456</id> 

<nom>REMY</nom> 

<prenom>Emmanuel</prenom> 

<e-mail>emmanuel . remy@orange . f r</e-mail> 
</client> 

Mapping entre WSDL etj AX-WS/J AXB : 

Le document WSDL qui est genere par le serveur d'applications respecte le standard XML 
Schema. Ce standard permet de definir precisement les types de chaque element constituant le 
document XML. Ces types sont important puisqu'ils definissent les parametres de chaque 
methode de la classe qui constitue le service web. Ainsi le mapping entre une classe Java est son 
correspond XML peut se faire correctement grace a JAXB en respectant les types proposes. 
Vous avez justement ci-dessous la correspondance entre les types XML Schema et les types Java: 



XML Schema 


Types Java 


xsd:byte 


Byte 


xsd:Boolean 


Boolean 


xsd: short 


Short 


xsd:int 


Integer 


xsd:long 


Long 


xsd: float 


Float 


xsd: double 


Double 


xsd: string 


java.lang. String 


xsd:dateTime 


java.util. Calendar 


xsd:integer 


j ava.math.Biglnteger 


xsd:decimal 


java.math.BigDecimal 


xsd:QName 


java.xml.namespace.QName 


xsd:base64Binary 


Byte [ ] 


xsd:hexBinary 


Byte [ ] 



Vous remarquez que le mapping propose par le couple JAX-WS/JAXB utilise systematiquement 
les classes enveloppes plutot que les types primitifs. Vous pouvez malgre tout utiliser les types 
primitifs pour les parametres de vos methodes puisque l'auto-boxing entre la classe enveloppe et 
son type primitif se realise automatiquement, sauf pour les tableaux d'octets. En effet, un Byte[] 
est total ement different d'un byte[]. 

Generalement, la definition de tous les types utilises par le service web, notamment par les 
parametres des methodes accessibles sont places dans un fichier a part et qui correspond 
justement au Schema prevu. Ainsi, nous aurons done deux fichiers, le fichier WSDL qui porte 
l'extension <*.wsdl> qui fera lui raeme reference au fichier XML Schema dont l'extension est 
generalement <*.xsd>. 
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Comment developper un service web avec J AX-WS. 

En realite, le developpement d'un service web est relativement simple bien que plusieurs 
technologies soient mises en oeuvre. Telle est la force de Java EE. Pour cela, il existe plusieurs 
phases de generation de code qui entre en jeu et qui mettent en oeuvre toute la tuyauterie 
technique. Le developpement et l'utilisation d'un service web comporte quatre phases : 

1. Developpement du service web proprement dit. 

2. Generation des artefacts cote serveur (Skeletons). 

3. Generation des artefacts cote client (Stubs). 

4. Demarrer le serveur en deployant le web service. 

5. Appel du service web chez le client. 

Un artefact est compose de l'ensemble des documents necessaires a un service web. Nous 
pouvons citer par exemple le document WSDL ou encore les classes Java qui formeront les 
messages SOAP d'echanges XML. 

1- Developper un service web : 
Outils a installer : 

O JDK1.6 

o Editeur Java : Eclipse. 
Creer un projet Java en utilisant JDK1.6 comme compilateur et environnement 
d' execution Java. 
Structure du projet 



a-Wr TP_W5JW51 


S--& .settings 


E-& bin 


Q-& src 


B-& ws 


i-'i j=HWHPP 


® .dasspath 


■■■\X\ .project 



Creer la classe BanqueWS.java du package ws : 
package ws; 

import Java. util. Date; 

import javax. jws.WebMethod; 

import javax. jws.WebParam; 

import javax. jws.WebService; 

import javax. jws. soap .SOAPBinding; 

§WebService(targetNamespace="http://bk/test", 
serviceName="BanqueService" ) 

©SOAPBinding ( style=SOAPBinding . Style . DOCUMENT, 
use=SOAPBinding . Use . LITERAL ) 

public class BanqueWS { 

private double tauxDeChange=ll; 
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§WebMet hod (oper at ionName=" conversion") 

public double conversionDhEuro(@WebParam(name="montant" )double 



mt){ 



return tauxDeChange*mt; 

} 

@WebMethod(operationName="changeTaux") 
public boolean changeTaux(double taux){ 

this. tauxDeChange=taux; 

return true; 

} 

§WebMet hod ( oper ationName="dateDuServeur") 
public Date getServerDate(){ 
return(new Date()); 

} 



Cette classe defini un web service nomme BanqueService qui est defini par une variable 
d'instance tauxDeChange ettrois methodes : 

o Methode nominee conversion qui permet de retoumer un montant converti de 
l'euro en dh en utilisant le taux de change courant. 

o Une methode qui permet de modifier le taux de change 

o Une methode qui permet de retoumer la date du serveur. 

Comme nous l'avons decouvert dans le chapitre precedent, les annotations JAX-WS sont specifiques aux 
services web. Elles permettent d'agir sur la structure d'un document WSDL en modifiant certains 
parametres du service ou des methodes qui le compose. Dans cette rubrique, nous allons decrire plus 
precisement le comportement de ces annotations. 

• L'annotation principale pour definir un service web est @javax.jws.WebService. Cette annotation 
s'applique a une classe et utilise eventuellement plusieurs attributs qui permettent, par exemple, de 
specifier la localisation d'un service web. 

Voici La liste des attributs qu'il est possible de mettre en oeuvre : 

1- name : definit le nom du service web. Ce nom se trouve alors dans le fichier WSDL dans l'attribut 
name de la balise <portType>. La valeur par defaut est le nom de la classe d'imlementation, ici 
BanqueWS. 

2- serviceName : definit le nom du service. Ce nom se trouve dans le fichier WSDL dans l'attribut 
name de la balise <service>. La valeur par defaut est le nom de la classe d'implementation suivie 
du suffixe "Service", ici done BanqueWSService. 

3- wsdlLocation : definit l'URL, qu'elle soit relative ou absolue, d'un fichier WSDL existant. Par 
defaut, ce fichier est auto-genere lors du deploiement. 

4- endpointlnterface : definit le nom complet de l'interface "endpoint" definissant les methodes du 
service web. Cela permet au developpeur de separer le "contrat" (l'interface) de l'implementation. 
L 'implementation de cette interface par le service n'est pas requise. L'interet de cette solution est 
egalement d'affecter des annotations de mapping Java vers le WSDL dans l'interface et non dans 
la classe d'implementation. 
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• L' annotation @WebMethod est utilisee pour declarer les methodes accessibles par le service web 
(nous parlons d'operation dans le protocole SOAP). Voici les details des attributs qu'elle contient : 

operationName : definit la valeur de l'attribut name de la balise <operation> dans le fichier 

WSDL. Celui-ci represente le nom de l'operation. 
exclude : marque une methode comme etant non disponible par le service web. Ce parametre 

est utilise lorsque nous souhaitons masquer une methode heritee, par exemple. 

• Une methode qui n'a pas de parametre de retour peut etre annotee par @Oneway. 

• Les parametres de la methode ainsi que la valeur de retour peuvent aussi etre changees. L'annotation 
@javax.jws.WebParam permet de controler la generation du WSDL qui concerne les parametres de 
la methode. Ainsi, l'annotation @WebParam permet de preciser des informations concernant les 
arguments des operations definies dans le fichier WSDL. Voici le detail des attributs disponibles : 

name : definit le nom du parametre qui sera utilise dans le fichier WSDL. Par defaut, le nom 

de l'argument (du code Java) est utilise. 
header : indique si la definition du parametre se trouve dans l'en-tete (header) plutot que dans 

le corps (body). La valeur par defaut etant false, la definition se trouve done dans le corps. 
mode : indique si le parametre est utilise en entree, en sortie ou les deux. Pour specifier ce 

type, d faut utiliser l'enumeration WebParam.MODE (Valeurs : IN, OUT, BOTH). 
targetNamespace : definit le namespace a utiliser. Par defaut, nous utilisons un namespace 

vide. Cet attribut est a utiliser si le parametre est mappe dans l'en-tete. 

• L'annotation @WebResult est presque identique, mais elle annote la valeur de retour de la methode. 

2- Generation des artefacts cote serveur (Skeletons). 

Pour generer les artefacts du web service cote serveur, vous pouvez utiliser l'utilitaire 
wsgen fourni par jdkl.6. Nous allons faire cette operation sur ligne de commande : 

• Verifier si la variable d'environnement path pointe c:\jdkl.6\bin 

• Sur ligne de commande, il faut se placer dans le dossier sre de votre projet 

• Executer la commande : wsgen -s . -wsdl -cp ../bin ws.BanqueWS 



cv C:\WINDOWS\system32\cmd.exe 










-1 


"1 


C:\TPWS\TP_WS_JWSl\src>wsgen -s 
C : \TPWS\TP_WS_JWS l\s rc>_ 


. -wsdl 


-cp 


./bin 


ws . BanqueWS 




^ 


hi 








1 


► 


A 



L'option -s suivie de . , indique a wsgen de placer les fichier source (.Java) dans le 

dossier courant : src. 

L'option -wsdl peut etre utilise pour generer le wsdl du web service. Ce qui n'est pas 

obligatoire, car le serveur le genere automatiquement a la demande du client. 

L'option -cp suivie de ../bin indique a wsgen que la classe ws.BanqueWS se trouve dans 

le dossier bin du projet. 
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• Les fichiers generes : 

©■■■& .settings 
Q-& bin 
Q-& ws 

EJ-& jaxws 

Q> ChangeTaux. class 

Q> ChangeTauxResponse. class 

^j) ConversionDhEuro. class 

Q ConversionDhEuroResponse. class 

Q> GetServerDate. class 

Q GetServerDateResponse. class 

£y> BanqueWS. class 
[if] BanqueService_schernal.xsd 
[if] BanqueService.wsdl 
Q-& src 
Q-& ws 

D-& jaxws 

[T| ChangeTaux, Java 

\T\ ChangeTauxResponse. Java 

\±\ ConversionDhEuro. Java 

[2] ConversionDhEuroResponse. Java 

[T| GetServerDate. Java 

■■■\y\ GetServerDateResponse. Java 
\T\ BanqueWS. Java 
[if] BanqueService_schemal.xsd 
[if] BanqueService.wsdl 
■@] .dasspath 
[if] .project 

Pour chaque methode du web service, Putilitaire wsgen, genere deux classes Java qui 
permettent de serialiser et de deserialiser les messages SOAP. 

Le wsdl genere est le suivant : 

version="1.0" encoding="UTF-8" standalone="yes"?> 
<definitions targetNamespace="http://bk/test" name="BanqueService" 
xmlns="http : //schemas . xmlsoap . org/wsdl/" xmlns : tns="http : //bk/test" 
xmlns : xsd="http : //www. w3 . org/2001/XMLSchema" 
xmlns : soap="http: //schemas . xmlsoap .org/wsdl/soap/"> 
<types> 

<xsd:schema> 

<xsd : import namespace="http: //bk/test" 
schemaLocation="BanqueService_schemal . xsd"/> 
</xsd : schema> 
</types> 
<message name="conversion"> 

<part name="parameters" element="tns:conversion"/> 
</message> 
<message name="conversionResponse"> 

<part name="parameters" element="tns:conversionResponse"/> 
</message> 
<message name="changeTaux"> 

<part name="parameters" element="tns:changeTaux"/> 
</message> 



<?xml 
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<message name="changeTauxResponse"> 

<part name="parameters" element="tns:changeTauxResponse"/> 
</message> 
<message name="dateDuServeur"> 

<part name="parameters" element="tns:dateDuServeur"/> 
</message> 
<message name="dateDuServeurResponse"> 

<part name="parameters" element="tns : dateDuServeurResponse"/> 
</message> 

<portType name="BanqueWS"> 
<operation name="conversion"> 

<input message="tns: conversion "/> 
<output message="tns : conversionResponse"/> 
</operation> 
<operation name="changeTaux"> 

<input message="tns:changeTaux"/> 
<output message="tns : changeTauxResponse"/> 
</operation> 
<operation name="dateDuServeur"> 

<input message="tns : dateDuServeur"/> 
<output message="tns : dateDuServeurResponse"/> 
</operation> 
</portType> 
<binding name="BanqueWSPortBinding" type="tns:BanqueWS"> 

<soap: binding transport=" http://schemas.xmlsoap.org/soap/http" 
style="document"/> 

<operation name="conversion"> 
<soap: operation soapAction=""/> 
<input> 

<soap:body use="literal"/> 
</input> 
<output> 

<soap:body use="literal"/> 
</output> 
</operation> 

<operation name="changeTaux"> 
<soap: operation soapAction=""/> 
<input> 

<soap:body use="literal"/> 
</input> 
<output> 

<soap:body use="literal"/> 
</output> 
</operation> 

<operation name="dateDuServeur"> 
<soap : operation soapAction=""/> 
<input> 

<soap:body use="literal"/> 
</input> 
<output> 

<soap:body use="literal"/> 
</output> 
</operation> 
</binding> 
<service name="BanqueService"> 

<port name="BanqueWSPort" binding="tns : BanqueWSPortBinding"> 
<soap: address location="REPLACE_WITH_ACTUAL_URL"/> 
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</port> 

</service> 

</definitions> 



• Ce fichier fait ensuite reference a la definition des types qui sont decrit dans le fichier 

correspondant au XML Schema et qui porte l'extension <.xsd>. Ce fichier est egalement auto- 
genere par Putilitaire wsgen. Le contenu de ce fichier nomme BanqueService_schemal.xsd est 
le suivant : 
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> 
<xs:schema version="1.0" targetNamespace="http ://bk/test" 
xmlns : tns="http : //bk/test" xmlns : xs="http : //www. w3 . org/2001/XMLSchema"> 

<xs : element name="changeTaux" type="tns :changeTaux"/> 
<xs : element name="changeTauxResponse" type="tns : changeTauxResponse"/> 
<xs: element name="conversion" type="tns :conversion"/> 
<xs : element name="conversionResponse" type="tns : conversionResponse"/> 
<xs: element name="dateDuServeur" type="tns :dateDuServeur"/> 
<xs : element name="dateDuServeurResponse" 
type="tns :dateDuServeur Response "/> 

<xs : complexType name="dateDuServeur"/> 

<xs : complexType name="dateDuServeurResponse"> 

<xs :sequence> 

<xs: element name="return" type="xs:dateTime" minOccurs="0"/> 

</xs: sequence> 
</xs : complexType> 

<xs : complexType name="conversion"> 

<xs :sequence> 

<xs: element name="montant" type="xs :double"/> 

</xs: sequence> 
</xs : complexType> 

<xs : complexType name="conversionResponse"> 

<xs :sequence> 

<xs: element name="return" type="xs:double"/> 

</xs: sequence> 
</xs : complexType> 

<xs : complexType name="changeTaux"> 

<xs :sequence> 

<xs: element name="arg0" type="xs :double"/> 

</xs: sequence> 
</xs : complexType> 

<xs : complexType name="changeTauxResponse"> 
<xs :sequence> 

<xs: element name="return" type="xs: boolean"/> 
</xs: sequence> 
</xs : complexType> 
</xs: schema> 
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3- Creation du serveur. 

• Notre web service est pret a etre deploye dans un serveur d' application J2EE. Dans ce TP, 
nous allons creer notre propre serveur. 

• Dans le dossier src, creer une classe ServeurJWS.java dont le code est le suivant : 

import javax.xml.ws .Endpoint; 
import ws.BanqueWS; 
public class ServeurJWS { 

public static void main(String[] args) { 
String uri="http : //localhost : 8686/" ; 
Endpoint .publish(uri, new BanqueWS()); 
System. out . println("Web Service publie a "+uri); 



} 



} 



• Demarrer le serveur en executant l'application ServeurJWS. Le serveur demarre en 
affichant le message suivant : 

Web Service publie a http : //localhost : 8686/ 



4- Tester le web service avec un navigateur web 
• Lancer un browser et taper l'url : http://localhost:8686/BanqueService?wsdl 



Jj http://LocaLhost:8686/BanqueService?wsdL - Microsoft Internet Explorer 



Fichier Edition Affichage Favoris Outils ? 
©Preceded - g g fi*) p F 



e 0-^HDia^ 



- 



\ Adresse | 
'VMN 



1 il ^MflMfeadU^AMMMBBW 



jv] <|> C^Search Web " j W Wikipedia " 



" Q " Loading " | g Off 



(0) 



<?xrnl version="1.0" encoding="UTF-S" ?> 

< definitions ximlns=" http://schemas.Hml soap.org/wsdl/" xrnlns:tns="http://bk/test" xnnln5:x5d=" http://www.w3.org/2001/XMI_Sche ma" 
xrnlns :soap="http:// schemas.Kmlsoap.org/wsd l/soap/" targetNarnespace="http://bk/test" naime="BanqiieService"> 

- <types> 

- <x_d:schema> 

<xsd:innport schemaLocation="http://localhost:8686/BanqueService?Hsd=l" name_pace="http://bk/test" /> 
</xsd:schenna> 
</types> 

- <rne_sage narne="conversion"> 

<part elernent="tns:conversion" narne="parameters" /> 
</rnessage> 

- -^message narne="conversionResponse"> 

<part elernent="tns:conversionResponse" narne="parameters" /> 
</rnessage> 

- <rne_sage narne="changeTauH"> 

<part element="tns:changeTauH" nanne="parameters" /> 
-^/message > 

- <rne_sage narne="changeTauHResponse"> 

<part elernent="tns:changeTauKResponse" narne="parameters" /> 
</rnessage> 

- ^message narne="dateDuServeur"> 

<part element="tns:dateDuServeur" narne="parameters" /> 



Pour visualiser le schema XML des messages SOAP, taper l'url : 
http://localhost:8686/BanqueService?xsd=l 
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Adresse - http://localhost:8686/Banque5ervice?xsd=l 






MB 


r VMN _[v|f (^Search Web ' 


W Wikipedia - 


| ffi ' ® ' S* Loading - | ©Off - 


■ 25°F - (0) - 



<?xrnl version="1.0" encciding="UTF-8" ?> 
<xs:scherna xrnlns:tns="http://bk/test" xmlns: 



:s="http://www.ui3.org/2001/XMLSchema" targetNarnespace="http://bk/test" version="1.0"> 



"changeTauH" type="tns:changeTauH" /> 

"changeTauKResponse" type="tns:changeTauHResponse" /> 
"conversion" type="tns:corwersion" /> 
"conversionResponse" type="tns:conversionResponse" /> 
"dateDuServeur" type="tns:dateDuServeur" /> 
"dateDuSerueurResponse" type="tns:dateDuServeurResponse" /> 

dateDuServeur" /> 

dateDuServeurResponse"> 



<xs:elernent narne= 
<xs:elernent name 
<xs:elernent name 
<xs\ element name= 
<xs:elernent name 
<xs:elernent name 
<xs:cornplexType name 

- <xs:cornplexType name 

- <xs:sequence> 

<xs:elernent name="return" type 
</xs:sequence> 
</xs:complexType> 

- <xs:complexType name="conversion" 

- <xs:sequence> 

<xs:elernent name="montant" type 
</xs:sequence> 
</xs:cornplexType> 

- <xs:cornplexType narne="conwersionResponse"> 

- < xs: sequence > 

<xs:elernent name="return" type= M Ks:double" /> 
</xs:sequence> 
</xs: complexly pe> 

- <xs:cornplexType narne="changeTauK"> 

- <xs:sequence> 

<xs:elernent name="argO" type= M Ks:double" /> 
</xs:sequence> 
<As:complexType> 

- <xs:cornplexType narne="changeTauKResponse"> 

- <xs:sequence> 

<xs:elernent name="return" type= M Ks:boolean" /> 
</xs:sequence> 
</xs:cornplexType> 
</xs:schema> 



Hs:dateTime" iminOccurs="0" /> 



"Ks:double" /> 



Pour tester les methodes, nous avons besoin d'un analyseur WSDL SOAP. La majorite 

des editeurs XML off re ce genre d' analyseur 

Lancer l'editeur xml Oxygen 

Dans le menu « outils », lancer Panalyseur WSDL SOAP. 

Dans la zone de texte WSDL URL de la fenetre qui apparait, taper 1' adresse du wsdl 

http://localhost:8686/BanqueService?wsdl 



LocaLisateur du fie hie r WSD 






1 FichierWSDL Demande SOAP sauvee 


WSDLURL: |//lo calho st: 8 6 8 6/BanqueS sttic e? ws dl v 


& & & 3 










\ Ouvrir | 


Annuler 







Cliquez sur le bouton Ouvrir 
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AnalyseurWSDLSOAP 



WSDL 



- -b x 



Services 

Ports 

Operations 

Actions 
URL: 
Action SOAP 



BanqueService 



BanqueWSPort 



conversion 



El 
3 

El 



http ://lo calho st: 8 6" 8 fJ/BanqueS ervic e 



Requete 



Fichiers joints 



<SOAP-ENV:Envelopexrnlns:SOAP-ENV= 
<SOAP-ENV:Header/> 
<SOAP-ENV:Body> 
<conversionxmlns="http://rjk/test"> 

< rn o nta nt xrn I n s="" > 1 2 </rn o nta nt> 
</con version* 
</SOAP-ENV:Boc!y> 
</S AP- E N V: E n ve I o p e> 



http://schemas.xmlsoap.org/soap/enveloper: 



j Envoyer j 



Ouvrir 



Enregistrer Regenerer 



■Reponse- 



<?xml version="1.0" ?> 

<soapenv:Envelope)(mlns:soapenv^"http://schemas.)(mlsoap.org/soap/enveloper 
xrnlns:xsd="http://www. w3.org/2001 /KMLSchema" xrnlns:ns1 ="http://bk/tesf> 
<soapenv:Body> 
<ns1 :conversionResponse> 

<return>132.0</return> 
</ns1 :conversionResponse> 
</soapenv:Body> 
</soapenv:Envelope> 



Cet outil est tres pratique car il vous permet de selectionner l'operation que vous voulez 
appeler via SOAP et taper dans la requete SOAP, les parametre de la methode. Et en 
cliquant sur le bouton Envoyer, la requete SOAP est envoyee au web service et la reponse 
SOAP s'affiche en bas de la requete SOAP 
Essayer de tester toutes les operations du web service. 

5- Creation d'un ClientJ ava. 

Creer un nouveau projet Java projet Java pour le client. 

Dans le dossier src, placer les deux fichier wsdl et XSD du web service. 
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Banque5ervice_schennal .xsd 
BanqueService.wsdl 



l-Wr Client_Jax_WS 
E-& bin 
E-& src 

! a I 

! a I 

® .classpath 
[«] .project 

• Avant de creer 1' application du client, nous avons besoin de generer les interfacts cote 
client (STUBS) a partir du wsdl. Cette operation peut etre effectuee en utilisant l'utilitaire 
wsimport fourni parle jdkl.6. 

• Avant de faire cette operation, nous avons besoin d'apporter une petite modification au 
niveau du fichier WSDL genere par wsgen. Cette modification concerne l'adresse du web 
service. Editer BanqueService.wsdl et remplacer la valeur de l'attribut location de 
Pelement <soap :address> qui se trouve dans Pelement <service>, de 
REPLACE_WITH_ACTUAL_URL par l'adresse reelle du web service : 

http : //localhost : 8686/BanqueService 



<service name="BanqueService"> 
<port name="BanqueWSPort" binding="tns :BanqueWSPortBinding"> 
<soap: address location="REPLACE_WITH_ACTUAL_URL"/> 

</port> 
</service> 

<service name="BanqueService"> 

<port name="BanqueWSPort" binding="tns :BanqueWSPortBinding"> 

<soap : address location="http: //localhost :8686/BanqueService"/> 
</port> 
</service> 

• Sur ligne de commande, placez vous dans le dossier src de votre projet. Et taper la 
commance : wsimport -s . BanqueService.wsdl 



"■• C:\WINDOWS\system32\cmd.exe 



queService. ws 

C: \youdocs\you2008\pro jets Eel ipse\WS_Hiage2\Cl ient_Jax_WS\src>ws import -s 
queService. wsdl 



Les fichiers suivants seront generes : 
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Web Services avec JAX-WS 2 



M.Youssfi 



i-ttr Client Jax_W5 
m-& bin 
3-& src 
3-& bk 
Q-& test 

mil swan 




■[»] Banque5ervice_schernal.xsd 
[»] BanqueService.wsdl 
■@] .dasspath 
[if] .project 

• II est temps maintenant de creer facilement un client Java pour notre web service. 

• Dans le dossier src creer la classe ClientJWS suivante : 
import bk. test .BanqueService; 

import bk. test .BanqueWS; 

public class ClientJWS { 

public static void main(String[] args) { 

BanqueWS service=new BanqueService( ) .getBanqueWSPort( ) ; 
System. out . pr in tin ("Date du serveur : "+service.dateDuServeur( ) ) ; 

double mt=100; 
System. out . println(mt +" Euro ="+service.conversion(mt)+" DH"); 
service . changeTaux(ll) ; 

System. out. println(mt +" Euro ="+service.conversion(mt)+" DH"); 
} 



• Resultat d'execution : 

Date du serveur :2009-01-13T12:53:01. 609+01:00 
100.0 Euro =1000.0 DH 
100.0 Euro =1100.0 DH 
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